語意化版本

• 我們跑完測試了，接下來我產品上 Production， 同樣地，我們要幫我們的產品貼上版本號
• 可是，版本號是如何做管理的，以及如何做撰寫的ㄋ，總要有一個統一的寫法，不然大家都隨便發就好，我甚至可以用底線來幫我控制版本
  • ex : release.exe、 release_.exe、release__.exe、release_______.exe
• 明顯地，我們不會想用底線幫我們做版本控管，那要怎麼大家一看到版本號就心知肚明你幹啥?
  

怎麼用

• 我們的版本號長相必須是 X.Y.Z

• X、Y 和 Z 必須是正整數，且分別代表

  1. X 主版本號
  2. Y 次版本號
  3. Z 修訂號

• 三個號的值必須以數值的方式做遞增，且不能在前面補 0

  • ex : 1.2.1 -> 1.2.2 -> 1.2.3
  • ex : 1.09.10 錯誤

X,Y,Z

X 主版本號( Major version )

• 通常是我們加了一個在目前環境獨立的API時，我們會把 X + 1
  • 本來沒有登入系統，這次更新後把它加了進來

Y 次版本號( Minor version )

• 為目前已有的系統加入新的feature不是bug，或是商務邏輯和程式碼有大量變更的時候
  • ex : 幫本來就有的點餐系統底下新增子功能，例如查看朋友訂了甚麼、hightlight你點的餐點......

Z 修訂號( Patch version )

• 人如其名，或許從英文更好理解，當我修改了系統的時候都要用修訂版本號

  • ex : 突然被公司 call 回去做的 Hotfix、 或是改了個 typo 等......

• 通常會以系統和API都穩定的時候發布，而這時候的版本通常使用 v1.0.0

開發的版本?

• 但假如我想要在開發的時候進行版本的標示?

  • 我們會以主版本號為 0 來當作開發初始階段
  • ex : 0.y.z

• 我們這邊只講了了大概的版本觀念，有興趣或是對版本號想有更深入研究的朋友歡迎參考下面兩篇

  • semver 中文版
  • semver 英文版